home *** CD-ROM | disk | FTP | other *** search
/ X User Tools / X User Tools (O'Reilly and Associates)(1994).ISO / sun4c / archive / tcltk.z / tcltk / man / catn / list.n < prev    next >
Text File  |  1994-09-20  |  1KB  |  67 lines

  1.  
  2.  
  3.  
  4. list(n)               Tcl Built-In Commands
  5.  
  6.  
  7.  
  8. _________________________________________________________________
  9.  
  10. NAME
  11.      list - Create a list
  12.  
  13. SYNOPSIS
  14.      list ?_a_r_g _a_r_g ...?                                            |
  15. _________________________________________________________________
  16.  
  17.  
  18. DESCRIPTION
  19.      This command returns a list comprised of all the _a_r_gs, or an  |
  20.      empty   string   if  no  _a_r_gs  are  specified.   Braces  and
  21.      backslashes get added as necessary, so that the  index  com-
  22.      mand  may  be  used on the result to re-extract the original
  23.      arguments, and also so that eval may be used to execute  the
  24.      resulting  list, with _a_r_g_1 comprising the command's name and
  25.      the other _a_r_gs  comprising  its  arguments.   List  produces
  26.      slightly  different results than concat:  concat removes one
  27.      level of grouping before forming the list, while list  works
  28.      directly from the original arguments.  For example, the com-
  29.      mand
  30.  
  31.           list a b {c d e} {f {g h}}
  32.  
  33.      will return
  34.  
  35.           a b {c d e} {f {g h}}
  36.      while concat with the same arguments will return
  37.  
  38.           a b c d e f {g h}
  39.  
  40.  
  41.  
  42. KEYWORDS
  43.      element, list
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63. Tcl                                                             1
  64.  
  65.  
  66.  
  67.